home *** CD-ROM | disk | FTP | other *** search
Text File | 1989-07-25 | 57.0 KB | 1,294 lines |
-
- PCOPY 7.87 Registration Request
-
-
- Thank you for your registration. It is sincerely appreciated!
-
- --------------------------------------------------------------------
- VISA/Mastercard orders are only accepted through telephone orders.
- Call the Public (Software) Library at 800-242-4775 to order NOW!
- --------------------------------------------------------------------
-
- _____ Registration of all Patriquin Utilities with
- program disk and User's Guide........................$45.00
-
- When you register the below versions, you will receive registration
- codes along with the latest version of the utility.
-
- _____ PCOPY -- Advanced windowed DOS COPY alternative...$15.00
- _____ PALERT -- Warns you of low disk space..............$15.00
- _____ PATTR -- Manage attributes of DOS files...........$10.00
- _____ PDAILY -- Automatically execute commands once/day..$10.00
- _____ PDELETE -- Save space with automatic disk cleanup...$15.00
- _____ PPRINT -- Advanced file print w/special formats....$15.00
- _____ PSEARCH -- Advanced find files with text............$15.00
- _____ PTOUCH -- Change date and time on DOS files........N/C
-
- _____ Update a registered set with new disk and manual.
- Registered users only Ser: __________ ........... $15.00
-
- ****************************************************************
-
- Name: __________________________________________________
-
- Company: _______________________________________________
-
- Address: _______________________________________________
-
- _______________________________________________
-
- City: ________________________ State: ________ Zip: __________
-
- I learned about the utilities from: ____________________________
-
- If BBS indicate name and number please._________________________
-
- ________________________________________________________________
-
- Please register the software under the following name:
-
- ____________________________________________________________
-
- Send to: Norm Patriquin
- P.O. Box 8263
- San Bernardino, CA 92412
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- P C O P Y
-
-
-
- -------------------------
- Users Guide and Reference
- -------------------------
-
-
-
-
- Version 7.87
- July 1989
-
-
-
-
-
-
- Patriquin's BBS 714-369-9766
-
- Copyright 1986, 1987, 1988, 1989 by Norm Patriquin
-
-
-
-
-
-
- PCOPY Users Guide/Reference Copyright 1989 N. Patriquin
- ----------------------------------------------------------------------
-
- Table of Contents
-
-
-
-
- PCOPY -- Advanced replacement for DOS COPY . . . . . . . . . . . . 1
-
- About PCOPY . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
-
- Features: . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
-
- Command Mode Parameters . . . . . . . . . . . . . . . . . . . . 4
-
- Setting of default parameters (DOS Environment) . . . . . . . . . 15
-
- PCOPY Command Examples . . . . . . . . . . . . . . . . . . . . . . 15
-
- Program Maintenance: . . . . . . . . . . . . . . . . . . . . . . . 16
-
- Registering The Utilities . . . . . . . . . . . . . . . . . . . . 22
-
- VISA / Mastercard / Telephone Registration . . . . . . . . . . . . 22
-
- PCOPY Registration Request . . . . . . . . . . . . . . . . . . . . 23
-
- Reporting Problems .............. . . . . . . . . . . . . . . . . 24
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- i
-
- PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 1
- ----------------------------------------------------------------------
-
- PCOPY -- Advanced replacement for DOS COPY
- ------------------------------------------
-
- The DOS COPY command is one of DOSs most used commands.
- Unfortunately, its abilities are very limited and are not
- sufficient for many disk maintenance chores performed by users.
- PCOPY is similar to the DOS COPY command in that it copies file
- data between disks and hard disk directories. In addition, PCOPY
- is greatly superior to DOS copy in that it provides intelligent
- file selection and processing options. PCOPY options allow you to
- use a single PCOPY command to perform a function that would require
- many DOS copy commands and much thought.
-
- In addition to superior file copy functions, PCOPY provides a safer
- way to copy files than is provided by the DOS COPY command. It
- allows you to copy only newer files or update a directory with the
- contents of another. PCOPY will never overlay a file accidently.
-
- PMOVE is an option of the PCOPY command used to move files between
- disks and directories on disks. PMOVE combines the functions of
- DOS COPY and DELETE commands to make moving files very easy. In
- addition to just moving files, PMOVE also allows selection criteria
- to be specified to better qualify the files to be moved.
-
- PMOVE automatically determines the environment the move is
- requested for and then determines if the data must be moved or if
- the file can be moved by renaming. Moving with rename is allowed
- if the move is to another directory on the same disk device. If a
- rename move can be done, it is much faster than moving the data, it
- helps to keep from fragmenting disk free space, and allows very
- large files to be moved between directories when they could not
- normally be moved with DOS COPY because of insufficient space.
-
- For the remaining part of this documentation we will refer to the
- program as PCOPY. Remember that the only difference between PCOPY
- and PMOVE is that PMOVE removes the file from the source location
- after it has been successfully copied to the desired location.
-
- PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 2
- ----------------------------------------------------------------------
-
- About PCOPY
- ------------
-
- PCOPY is developed to allow standard DOS wild card pathnames in the
- source file specifications, and standard pathnames for the target
- directory specification.
-
- PCOPY attempts to anticipate your needs and help you accomplish
- your task. For instance, if PCOPY determines that the target
- directory name does not exist, it will ask you if it is to be
- created. If you respond <YES>, the directory will be created for
- you. With the /SAve option, if you are about to overlay another
- file with a duplicate name, you will be asked if the older
- duplicate file is to be renamed with a version number.
-
- PCOPY keeps you out of trouble. If it saves you from overlaying a
- needed file just once, it has paid for itself. Think of all the
- times it might have saved you in the past.
-
- For an immediate command summary, enter the PCOPY command without
- any parameters. Help panels will be displayed.
-
- Features:
- ---------
-
- ** Copies files to and from any disk or directory.
-
- ** Allows you to save older versions of files with new names
- before replacing them.
-
- ** Moves files by copying them or renaming them to the new
- location.
-
- ** Deletes the original file if /X is specified.
-
- ** Creates target directories if needed.
-
- ** Makes sure the DOS archive flag is set correctly for each file
- as it is moved.
-
- ** Preserves the DOS date and time for each file moved.
-
- ** Allows user to pause processing at any time by pressing any
- keyboard key. Once stopped, the program can be terminated by
- pressing <ESCAPE>.
-
- ** Provides file selection and processing control options to
- tailor the move process to your own needs.
-
- ** Allows commands to be tested so you may be sure that commands
- are specified as you desire.
-
- PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 3
- ----------------------------------------------------------------------
-
- ** Copy updated files to a special disk or directory.
-
- ** If there is not sufficient space on the current target disk,
- PCOPY will allow you to place another disk in the drive and
- continue processing. This allows you to easily copy groups of
- files larger than disk size to other computers.
-
- ** Start with a specific file in a directory.
-
- ** End with a specific file in a directory.
-
- ** Process files based on the date stored in its directory
- entry.
-
- ** Warns you before overlaying a file unless specific parameters
- indicating otherwise are specified.
-
- ** Checks target disk for available space before starting to
- copy files. This prevents time from being wasted when the
- copy will not be able to complete.
-
- ** Gives you constant status of the progress of the command.
-
- ** Runs with windows or using standard DOS screen output.
-
- ** Format new floppy disks as they are needed by pressing <F3>
- at any prompt.
-
- ** Process one directory, a single directory subtree or all
- directories on a disk (/S).
-
- ** Allows you to indicate that multiple input disks are to be
- used and prompts for the next one after each disk is
- processed.
-
- ** Create a series of output disks filled efficiently with files
- from the source location.
-
- ** DOS ERRORLEVEL set to indicate error conditions. PCOPY may be
- used in .BAT files to copy files and you may confirm results
- are good.
-
- ** Special Wildcard matching *DISK*.* allows you to select all
- files with specific text in filename.
-
- PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 4
- ----------------------------------------------------------------------
-
- Command Mode Parameters
- -------------------------
-
- PCOPY allows several command parameter switches to be specified to
- qualify the copy criteria. All these parameters are optional. If
- no parameters are specified, PCOPY will act similar to the DOS COPY
- command except that it will prompt you before overlaying any files.
- The PCOPY command is used like DOS COPY except for these switches.
- The command format and switch parameters are described below. A
- quick review of command parameters is always available by entering
- the PCOPY command without any parameters.
-
-
- COMMAND FORMAT:
-
- PCOPY from_file_spec [to_file_spec] [ (/ switches) ]
-
-
- [from]
- Enter the DOS file specification for the directory and file
- names to be moved.
-
- The filename portion of the file specification may contain
- wild card characters documented by DOS (* and ?).
-
- Special pattern selection of *DISK*.* may be specified.
- *DISK*.* would select all files that have the chars 'DISK'
- anywhere in the first portion of the filename. *DI*S*K*.*
- type specification also works.
-
- As an alternative, a file containing a list of input files may
- be supplied. Create a file containing lines with a filename
- or complete pathname on each line. Provide this filename as
- the source filename to PCOPY and add an @ character before the
- name. The list of files will be processed as if they were all
- specified on the input command line.
-
- For file list processing, PCOPY understands the output of the
- DOS DIR command. You may use the DOS redirection feature to
- direct DIR output to a file, edit the file to add or remove
- entries, and then provide this to PCOPY as input. For
- example:
-
- DIR A: >DIRLIST
- (edit dirlist)
- PCOPY @DIRLIST B:
-
- PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 5
- ----------------------------------------------------------------------
-
- [to]
- Enter the DOS file specification for the directory and
- filename to be copied to. If the "to" specification is not
- entered, files will be moved to the current directory.
-
-
- /A Archive - Selects only files that have been marked updated by
- DOS. This flag is updated by DOS whenever a file is
- processed with an intent to change or create new data.
-
-
- /AP Append. All source files selected will be concatenated and
- placed together in a single output file. The output file will
- be given the name of the first, or only selected input file, or
- the target filename specified.
-
-
- /B BACKUP - When specified, the DOS Archive (Update) flag is
- reset after a file has been copied.
-
-
- /BA BAtch file processing. PCOPY always checks to determine if the
- user has pressed a key to pause PCOPY processing. This check
- can interfere with programs that store keystrokes in the
- keyboard buffer for subsequent activity. The /BA parameter
- sets "no-windows" mode and disables the "key press" check to
- leave stored keystrokes undisturbed.
-
-
- /BW Forces PCOPY to use monochrome colors even when it detects a
- color display environment.
-
-
- /CD:xxx
- A special parameter that allows you to use the advanced
- selection criteria offered by PCOPY to select files for
- processing by any command of your choice. Users have
- indicated they would like to select files by date, and archive
- them into a file for saving. This parameter allows PCOPY to
- invoke any command of your choice for each file PCOPY selects.
- With this parameter, PCOPY will not copy your data, it is
- simply a file selection utility.
-
- PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 6
- ----------------------------------------------------------------------
-
- To use this parameter you must supply the command PCOPY is to
- execute. To be compatible with DOS command line option
- specifications, you use special substitution characters to
- build a command to your specifications. The following special
- characters are used:
-
- # -- Is replaced with the full pathname of the file to be
- processed.
- $ -- Is replaced with the filename of the file selected.
- @ -- Is replaced with the target filename PCOPY would have
- copied the file to, if the copy operation was active.
- [ -- Is replaced with a single space character.
- ] -- Is replaced with a backslash character (\).
- } -- Is replaced with a slash (/) characters. This must be
- used to allow a command to include / parameters, since
- PCOPY will interpret a / as one of its own parameters.
-
- The following example shows how PCOPY can be used to drive an
- EDIT command with variable parameters:
-
- PCOPY *.c/d:)1jan89/cd:EDIT[#[}F[}pf:]log
-
- Assuming file C:\COMP\TEST.C was selected, the following
- command would result:
-
- EDIT C:\COMP\TEST.C /F /PF:\LOG
-
- To execute the command, PCOPY invokes a second copy of the DOS
- command processor. When the /CD parameter is used, PCOPY
- forces operation without windows to eliminate screen flashing
- between commands.
-
-
- /CF:pth
- This parameter alters the meaning of the /CD parameter. When
- specified with a full DOS pathname (including the filename),
- it indicates that PCOPY is to write all generated commands to
- the specified file. The commands will not be executed by
- PCOPY. This allows you to generate a .BAT file that can be
- modified and executed at a mater time.
-
- The following sample will generate commands and place them in
- batch file DOIT.BAT.
-
- PCOPY *.c/d:)1jan89/cd:EDIT[#[}F[}pf:]log /CF:DOIT.BAT
-
- PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 7
- ----------------------------------------------------------------------
-
- /C2 /C3
- Specify /C2 or /C3 to use different colors when PCOPY is used
- with windows operation. To make this color change permanent,
- specify the parameter in the DOS environment variable.
-
-
- /D: [(] [)] [=] xxx Date.
-
- Select files based on the relationship between their last
- update date and the date specified. This parameter includes a
- date or number of days value.
-
- It may also contain a operator that reverses or modifies the
- use of the date specified.
-
- When xxx contains a date, the date is compared to the last
- update date of the file. The last update date of the file is
- the date contained in its directory entry. The file is
- selected if the condition specified by the condition modifier
- is met. The condition modifier meanings are:
-
- '(' Select files whose date is older than the date
- specified.
-
- ')' Select files whose date is newer than the date
- specified.
-
- '=' Select files whose date is equal to the date specified.
-
- If the condition operator is not specified, ')' is assumed.
-
- Date values may be specified in any of the following formats:
-
- MM/DD/YY MM-DD-YY DDMMMYY
- /D:)12/31/80 /D:(12-31-80 /D:=31DEC80
-
- If xxx contains a numeric value, that positive number is used
- to generate a date value a number of days prior to the
- current date. That date is used as in the calculation above.
-
- Example:
-
- /D:(1JAN86 - Process files updated prior to 1JAN86
- /D:)1JAN86 - Process files updated after 1JAN86
- /D:=1JAN86 - Process files updated 1JAN86
- /D:(5 - Process files modified prior to 5 days ago
- /D:)5 - Process files modified within the last 5 days
- /D:=5 - Process files modified 5 days ago
-
- PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 8
- ----------------------------------------------------------------------
-
- /D- Delete all files on target drive before starting copy.
-
-
- /D2 Add files to the files already on the first output disk. Then,
- delete all files from subsequent disks provided before
- copying to them. Use /D2 when you want to append files to
- a set of already existing disks. This parameter allows you
- to continue backing up to a partially used disk and then reuse
- disks already containing old unwanted backup files.
-
-
- /DC Directory Copy - Causes PCOPY to create a duplicate directory
- on the output disk for every directory processed on the source
- disk. Directories are only created when files are processed
- from them. See also the /S option. This is useful for copying
- all files, and directories, from one disk to another.
-
-
- /DL Same as /DC except that only the Last node of the source
- directory is copied to the target pathname specified.
-
-
- /DR:xxx
- Use to process multiple disk drives. /DR assumes the presence
- of the /S parameter causing all directories on the source disks
- to be processed. For those using PCOPY for backup, this allows
- PCOPY to process all disk drives with a single command.
-
- The following command will copy all modified files from hard
- drives C:, D:, and E:, to the floppy disk in drive A:. The
- /D2 parameter will insure each new output disk is cleared of
- all files before it is written to.
-
- PCOPY *.* A: /DR:CDE/A/D2
-
-
- /DS Same as /DC except that only the current directory level, and
- all its subordinate levels, are copied to the target
- directory. The target directory may contain a pathname with
- multiple directory levels. In this way, you can copy one
- directory structure below another directory structure.
-
-
- /E Select and move only files that exist on both the "from" and
- "to" directories. This causes all duplicate named files to be
- replaced.
-
- PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 9
- ----------------------------------------------------------------------
-
- /EX Designed for batch file operation. Use this parameter to
- prevent PCOPY from requiring you to press a key to terminate
- processing.
-
-
- /F:file
- First. Indicates that processing is not to start until the
- specified filename is encountered in the source directory.
-
- This parameter is most useful in restarting a move or copy
- from a location where it had previously terminated.
-
- You may specify DOS pattern name characters * and ? to
- identify the file to begin processing.
-
-
- /FI Fill output disks as efficiently as possible. Normally files
- are copied in the sequence they are found in the source
- directory. If a large file cannot be copied onto the output
- disk, a new disk is requested even though there may be enough
- space left on the output disk to hold other smaller files
- to be copied.
-
- The /FI parameter causes files to be copied in descending size
- sequence. When a file cannot fit on the output disk, before
- requesting a new output disk, PCOPY searches for another file
- that will fit on the disk. When a new disk is placed in the
- drive, PCOPY begins processing the larger files again.
- Eventually, all files requested will be copied.
-
-
- /IFA:pathname
- Check to determine that the source file does not already exist
- in an alternate directory before processing it. If it does
- not exist, processing will continue.
-
- Use just like IFP specified below.
-
-
- /IFP:pathname
- Determine the source file to be copied already exists in the
- pathname specified by IFP. If it does exist, process the file.
- If it does not exist skip the file.
-
- I.E. PCOPY *.BAT \newdir/IFP:\testdir
-
- Copies files from the current directory to \NEWDIR only if
- each file already exists in \TESTDIR.
-
- PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 10
- ----------------------------------------------------------------------
-
- /L:file
- Last. Processing is to stop after the specified filename is
- encountered in the scan of the directory. The file specified
- will be processed if it matches selection criteria.
-
- You may specify DOS pattern name characters * and ? to
- identify the file to begin processing.
-
-
- /LG LoG PCOPY activities. PCOPY will create a disk log of all
- actions it takes. Provided for those users using PCOPY as a
- backup system. The log will aid the user in later locating
- the disk a file has been backed up to.
-
- The log file will be named PCOPY.LOG. For DOS versions 3.0 or
- later, the log will be automatically created in the same
- directory PCOPY is executed from. Other DOS versions will put
- the log in the current directory.
-
- PCOPY will create the log if it does not exist. If it already
- exists, it will be added to. To begin a new log, delete
- PCOPY.LOG before running PCOPY.
-
-
- /M Stop screen from scrolling past the end without user
- intervention (MORE).
-
-
- /ME MErge -- Works like using /U and /X parameter to move the
- most current files from one directory into another. In
- addition, it deletes all the files that are not moved to the
- new location. This has the effect of merging the most current
- files from two directories into a single directory.
-
-
- /MU MUltiple input disk are to be processed. After the first
- input disk is processed, the user is prompted for additional
- disks. You may indicate yes to process more disks or no to
- conclude processing.
-
-
- /N Only move files that do not already exist on the target
- directory (New files). If the file already exists, no attempt
- will be made to move it.
-
- PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 11
- ----------------------------------------------------------------------
-
- /NA No-Archive. Only process files that do not have the DOS
- BACKUP indicator set in the directory entry. This has the
- affect of only processing those files that have already been
- backed up. Files not backed up will not be processed.
-
- /NP No Pause. Use when you have placed the /P parameter in the
- DOS environment with the SET PCOPY=/P command, and want to
- override it with no pause.
-
-
- /NW No Windows - Do not use windows during processing. All screen
- output will be done through standard DOS facilities.
-
-
- /O Omit files from processing. This option reverses the purpose
- of the source filespec in the command. Instead if selecting
- those files meeting the supplied file specification, all files
- except those matching the filespec will be selected.
-
- I.E. PCOPY *.BAT will cause PCOPY to select all files that do
- not have the extension .BAT.
-
-
- /P Pause before each file is moved and ask for approval to
- process it.
-
-
- /R Replace any duplicate files on the target disk or directory.
- PCOPY will replace files regardless of file dates and times.
-
-
- /RE REgister the program. Use this option to register your copy
- of the utility. You will need to have the registration number
- and code that is sent to after you request registration.
-
- Part of the registration screen also allows you to permanently
- modify the windows option. If you do not want windows during
- processing, use this option to change the windows program
- option. You do not need to be registered to change this
- information.
-
-
- /RO Read-Only. Normally processing skips files marked with the
- DOS Read-Only attribute. Using /RO causes Read-Only files to
- also be selected for processing.
-
-
- /S System -- If a source directory is supplied, that directory
- and all subordinate directories will be processed. If no
- source directory is specified, all directories on the disk
- will be processed.
-
- PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 12
- ----------------------------------------------------------------------
-
- /SA SAve -- Instead of overlaying already existing files with
- duplicate names, before the new file is copied, the file in
- the target directory is renamed with a version. This insures
- that no data is lost.
-
- If the file has an extension name, the last two characters of
- the extension are replaced with a number from 01 to 99
- depending on the next available number. PCOPY determines the
- next available number by looking in the directory for other
- files with similar names.
-
- This facility can be used to easily save versions of a file in
- a directory.
-
-
- /SF System Files. Normally processing skips files marked with the
- DOS System attribute. Using /SF causes System files to also
- be selected for processing.
-
-
- /SZ: [(] [)] nnn
- Select a file based on its size. The left paren indicates
- that files less than the indicated size are to be selected.
- The right paren indicates to select files greater than the
- size. If right or left paren are not specified, a left paren
- is assumed. Following are examples.
-
- /SZ:100 -- Select files less than 100 characters
- /SZ:(100 -- Select files less than 100 characters
- /SZ:)100 -- Select files greater than 100 characters
-
-
- /T Test the copy process. Use this switch when you would like to
- verify the PCOPY command entered is correct or to confirm the
- action that will be taken by your command. No files will be
- copied or changed.
-
- PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 13
- ----------------------------------------------------------------------
-
- /T: [(] [)] [=] xxx Time.
-
- Select files based on the relationship between their last
- update time and the time specified in the command.
-
- The /T parameter may also contain a operator that reverses or
- modifies the meaning of the date specified. This parameter
- works exactly like the /D:xxx date parameter. See the
- documentation for the /D parameter for a better idea of how
- time is specified.
-
- Examples:
-
- /T:(11:20a - Process files updated before 11:20 AM
- /T:(11:20 - Same as 11:20a
- /T:(11:20p - Process files updated before 11:20 PM
- /T:(23:20 - Same as 11:20p (military time)
- /T:)11:20p - Process files updated after 11:20 PM
- /T:=11:21p - Process files updated at 11:21 PM
- (within the 60 second period)
- /T:)1:20 - Leading zeros in hour may be omitted
-
-
- /TF Test First. Works similar to the /T parameter but after test
- processing is complete, PCOPY will ask you if the command is
- to be executed as if the /T parameter were not present. If Y
- is responded, the command will be executed and files will
- actually be processed.
-
-
- /U Update files. Only copy files that do not exist on the target
- directory or duplicate filenames that are newer than their
- counterparts on the target directory or disk.
-
- Use of this option results in the most current version of each
- selected file being at the target location.
-
-
- /V Verify -- Use the DOS verify option while copying data. This
- causes all data to be reread after it is written to disk to
- insure it was written properly.
-
-
- /WH Indicates WHy files are not selected for processing. Normally
- PCOPY will not show file names not selected for processing.
- /WH causes each filename not processed to be displayed with a
- message indicating why it was not processed.
-
- PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 14
- ----------------------------------------------------------------------
-
- /WT WaiT for proper disks to be mounted before beginning
- processing. This parameter is intended primarily for floppy
- disk system users. Before beginning the copy process, PCOPY
- will ask you to place the proper disks in the drives. This
- Allows you to have PCOPY on a different disk than the disks
- being processed.
-
-
- /X Move files. Changes PCOPY's function to move files. It will
- Delete each file from the source location after the copy is
- performed. If the move is to another directory on the same
- disk the directory entry for the file is moved without having
- to move the data. This provides for the fastest move possible.
-
- PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 15
- ----------------------------------------------------------------------
-
- Setting of default parameters (DOS Environment)
- -----------------------------------------------
-
- Default parameters are parameters that do not need to be specified
- each time PCOPY is started. Any PCOPY parameter may be specified
- as a default parameter.
-
- Use the DOS SET command to specify the parameter name and contents
- to be used by PCOPY each time it is started. The following example
- indicates that PCOPY is always to assume /U and /NW are specified:
-
- SET PCOPY=/U/NW
-
- Once this DOS command is issued, each subsequent use of PCOPY will
- operate as if these parameters have been specified on the command
- line. The SET command is most commonly placed in the AUTOEXEC.BAT
- file so it may be in effect every time your machine is started.
-
-
- PCOPY Example commands
- ----------------------
-
- 1. Copy all files in directory \GEN to directory \SAVE. Do not
- overlay any file without first asking.
-
- C> PCOPY \GEN \SAVE
-
- 2. Copy all files in directory \GEN to directory \SAVE. Replace
- any already existing file with newer files only.
-
- C> PCOPY \GEN \SAVE/U
-
- 3. Copy all *.BAT files from current directory to \SAVE
-
- C> PCOPY *.BAT \SAVE or PCOPY *.BAT \SAVE\*.*
-
- 4. Move all files in current directory to disk in drive A:
-
- C> PMOVE *.* A:/X
-
- 5. Search hard disk C: for any files ending with .WKS and move
- all the files to a new directory named \WKSDIR.
-
- C> PCOPY c:*.* c:\WKSDIR /X/S
-
- 5. Backup all files on hard disk C: to multiple floppy disks on
- drive A:.
-
- C> PCOPY *.* a: /S/A/B/DC
-
- PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 16
- ----------------------------------------------------------------------
-
- Program Maintenance:
- --------------------
-
- Version 1.0
- -- Multiple file move/copy utility with /U /N and /R parameters.
-
- Version 2.0 June 1986
- -- Added ability to create directory and detect full disks.
-
- Version 3.0 August 1986
- -- Window operation added.
- -- Improved help.
- -- /B /DC /D- /E /RE /S /SA /SF /V
-
- Version 4.0 August 18, 1986
- -- /ME /SF /RO parameters added.
- -- Corrected problem with /DC parameter and directory scanning.
-
- Version 5.0 October 13, 1986
- -- Corrected /B parameter to reset backup directory indicator
- after file is processed.
- -- Added /MU parameter to process multiple input disk volumes.
- -- Various documentation corrections. Special thanks to Edward
- Koch for technical editing of the document.
- -- Correct /ME parameter. Merge was deleting the target file,
- not the source.
- -- Added selection by size with /SZ:nnn
- -- Suspend and execute a DOS command from any question or prompt.
- Press <F3> to accomplish this. This is particularly useful to
- format new floppy disks when new ones are needed.
- -- Process a directory tree if /S is specified and a directory
- name is supplied in the source specification. Previous
- releases would only process a single directory, without /S, or
- the entire disk with the /S parm.
-
- Version 5.1 November 5, 1986
- -- Added complete capability to rename files using DOS global
- characters ? and * in source and target specification
- -- Extended ability to copy and create new directories.
- -- Allow to copy a directory structure below another structure.
- -- If directory copy specified /DC and the target directory also
- has a pathname, the source path is added to the target path.
- -- Ability to copy a single directory node below an already
- existing directory structure. Use /DL.
- -- Ability to copy a complete directory substructure with a
- single command.
- -- Problem corrected where ending totals were not updated after
- last file copied.
- -- When /R (replace) specified, print messages indicating if
- processed files are newer, older or duplicates of overlaid
- files.
-
- PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 17
- ----------------------------------------------------------------------
-
- Version 6.1 June 27, 1987
- -- Added /IFP and IFA command line parms to control file
- selection based on a duplicate filename being present or
- absent in another directory.
- -- Added /WHy parameter to cause PCOPY to show why files were not
- copied.
- -- Added /NS to allow PCOPY to run with No Sounds (Beeps)
- -- Added /BA to allow PCOPY to be used without intervention in
- DOS .BAT files. The keyboard buffer is not checked for a key
- to stop processing so keyfake can be used and a no windows
- mode is used.
- -- Dressed up the help screens
- -- Additional message to indicate files skipped due to command
- parameter options.
- -- A SET PCOPY= environment specification may be specified with
- command parameter variables to allow you to have parameters
- active during every use of PCOPY without having to specify
- them.
- Example:SET PCOPY=/WH/U/NW
- -- When large files are being copied PCOPY will now show the
- number of characters copied as the file is processed. This is
- in window mode only.
- -- Shows date and time for each file copied
- -- No window mode now shows count of files processed
-
- Version 6.2 June 29, 1987
- -- Corrected problem causing system hangup when moving files over
- 64k in size with no window mode.
-
- Version 6.4 September 7, 1987
- -- PCOPY was rejecting a move request to the same disk when there
- was less free space on the disk than was the size of the file.
- The disk space was not actually needed because the file was
- going to be moved. Corrected.
-
- Version 6.5 September 14, 1987
- -- When long target pathnames were specified and a replace
- message was displayed for the user, the system would lock up
- after getting the users response. This was due to the message
- area being too short to handle the long pathname. This has
- been corrected.
- -- /NP parameter added so users coupe put the /Pause parameter in
- their environment variable and still override it when needed.
- /NP = No Pause
- -- When in windows mode, intercept the DOS interrupt handler to
- neatly display a window with
- RETRY CANCEL FAIL ABORT
- failed I/O attempt.
-
- PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 18
- ----------------------------------------------------------------------
-
- -- If the user has already been asked if it is ok to replace a
- duplicate filename, and the /Pause parameter is specified,
- there is no need to pause to ask the user to confirm the
- process request. Corrected.
-
- Version 6.7 October 26, 1987
- -- F3 key to exit to DOS was locking up the system when used in
- non-windows mode. Corrected.
- -- Some messages were incorrectly wrapping the screen when
- displayed.
-
- Version 7.0 February 22, 1988
- -- /FI parameter added to FIll output disks most efficiently.
- This process moves largest files first, followed by smaller
- files until a disk is full or no files remain to be copied
- that can fit on the output disk.
- -- /DS added. Like /DC, only the directory and all its
- subordinates are copied below the specified target directory
- specification. This allows directory structures to be moved
- below other directory structures.
- -- /TF command parameter added. This causes PCOPY to ask if the
- live command is to be started after a test is completed. Good
- for .BAT files.
- -- Dates containing a '/' character were not accepted as valid
- dates. Corrected.
- -- When a directory name without filename pattern was specified
- as the /DC parameter was specified to copy directories to the
- target, the resulting directory was created without the first
- character of the directory name. Corrected.
- -- PCOPY locked the system if a command was entered that
- contained an error.
- -- Border color is no longer set as it caused CGA users problems.
- -- /D- parm to delete all files on target drive did not work when
- target drive letter is larger than B:
-
- Version 7.1 March 16, 1988
- -- FIX - /Omit parameter did not work when /S was also used
-
- Version 7.2 March 25, 1988
- -- FIX - Systems locked up when /FIll parameter was used and a
- file of zero length was encountered.
- -- Added capability to process a list of files by specifying an
- input filename as a list file. Precede with @.
-
- Version 7.3 April 20, 1988
- -- If file to be copied has Hidden or System attribute, make sure
- the resulting target file also has the same attribute.
-
- Version 7.4 May 15, 1988
- -- Allow multiple input file specifications to be processed with
- the @filename option.
-
- PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 19
- ----------------------------------------------------------------------
-
- -- Add /AP (append) option to allow multiple files to be copied
- to a single output file.
-
- Version 7.5 May 29, 1988
- -- /F: and /L: parameter modified to accept DOS wild card
- characters.
- -- fix -- /S parm with no filename was not always searching all
- directories.
-
- Version 7.6 September 2, 1988
- -- Support replacement of DOS read only files
- -- Turn off NOVELL share attribute when creating files. It was
- causing a create error when creating a file.
-
- Version 7.7 November 6, 1988
- -- /NA parameter added to allow files with the DOS archive bit on
- to be bypassed for processing.
- -- When /S /DC /MU specified and source dir of A:\ was also
- specified, PCOPY attempted to process the incorrect directory
- on the second disk and failed.
- -- Add /LG parameter to create PCOPY log file. See /LG parameter
- for more details.
- -- Added /WT parameter for floppy disk systems to cause PCOPY to
- wait for proper disks to be placed in drives before beginning
- processing.
- -- Removed limit of the number of directories that PCOPY is able
- to process.
- -- Added PCOPY command text to bottom window of processing
- screen.
- -- Added /EX command parameter to cause PCOPY to end without
- requiring the user to press a key. Designed for PCOPY .BAT
- file usage.
- -- Added /C2 and /C3 command parameters to provide alternative
- color screen displays.
-
- Version 7.72 January 1, 1989
- -- Directory search error corrected When dir is empty dir
- B:\*.*\DIRNAME\*.* returned Corrected
- -- Prevent create dir msgs from coming out in SIM mode too many
- times
- -- Prevent "More Recent" from wrapping window in test
- -- Filelist can contain wildcards that are fully processed.
- -- Add ability to select files by time of day last updated. See
- /T: parameter documentation
-
- Version 7.8 February 14, 1989
- -- Added ERRORLEVEL condition setting. May be tested when PCOPY
- completes to determine if an error occurred during PCOPY
- processing.
-
- PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 20
- ----------------------------------------------------------------------
-
- -- Special wildcard pattern matching capability added. *DISK*.*
- will select all files that have the chars 'DISK' in the
- primary part of the filename. *DI*S*K*.* also works.
- -- /DS parm corrections. Did not work without /S also specified.
- -- Command line shown on screen was incorrect after /TF
- specified.
- -- /D2 parm added. Append to first output disk and clean all
- subsequent output disks. Good for backup.
-
-
- Version 7.81 February 20, 1989
- -- Corrected OMIT /O feature. It did not work in 7.8.
- -- Added /BW parameter to support black and white on color
- screens.
- -- When /tf (test first) is used, only prompt to continue if test
- processing found files to process.
- -- Added message to indicate PCOPY was deleting files from the
- target disk as a result of the /D-or /D2 parameters
-
-
- Version 7.83 April 1989
- -- print a message when @ input file list entry has no matching
- filenames to process.
- -- Correct display of filenames that have special characters in
- them.
- -- Allow F3 to exit to DOS from the HELP screens
- -- NEW! /DR:xxx parameter to allow multiple input drives to be
- processed.
- -- NEW! /CD:xxx parameter to allow PCOPY selection criteria to be
- used to select files for processing by another command.
-
-
- Version 7.84 May 11, 1989
- -- Correct system lockup problem when /DR:ddd specified
- -- Attributes in window were sometimes incorrect
-
-
- Version 7.85 July 4, 1989
- -- @ filename input filelist processing was getting errors
- when attempting to process directories that contained
- subdirectories.
-
- PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 21
- ----------------------------------------------------------------------
-
- Version 7.86 July 8, 1989
- -- Error moving readonly files over other readonly files
- -- When no files processed, freespace showed -1
- -- When /NW and /TF specified, window still flashed on screen.
-
-
- Version 7.87 July 23, 1989
- -- Error deleting readonly file after it was moved to another
- disk. Corrected.
- -- Do not print banner for registered users.
- -- Support special chars such as รค for international users
- -- Revised help panels work faster and provide options to restore
- original screen on exit or leave help screen on display when
- exiting.
-
- PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 22
- ----------------------------------------------------------------------
-
- Registering The Utilities
- -------------------------
-
- PCOPY is distributed under the Shareware concept. This allows users
- to evaluate software for a short time to determine if it is useful
- to them. If you decide the software is of value to you, you are
- required to register it.
-
- This concept allows for quality software to be distributed at a
- reasonable cost. Hundreds of hours of my time has been invested in
- PCOPY. Continued registration will justify the continued upgrading
- of this utility to insure it remains up to date with current
- technology. In any case, I do greatly appreciate all users that
- care enough to register. I try to provide the best possible
- software for all you faithful supporting users.
-
- You may use the order form on the next page when registering PCOPY.
-
- Send registration requests to:
-
- Norm Patriquin
- P.O. Box 8263
- San Bernardino, CA 92412
-
- The registration charge is a one time fee that entitles you to all
- future versions of the product. These may either be obtained from
- normal Shareware sources or from me. I do not automatically send
- product updates to registered users. It is impossible to provide
- automatic upgrades at the low costs of these utilities.
-
-
- Site Licenses
- -------------
-
- I do welcome organizations to Site License one or more utilities at
- a reduced cost. Site Licenses allow you to be confident that all
- users in your organization are using authorized versions of the
- utilities. If you are interested in site licensing, indicate your
- interest on the registration form.
-
- VISA / Mastercard / Telephone Registration
- ------------------------------------------
-
- You may place a telephone order for the utilities using your credit
- card by calling Nelson Ford's Public (Software) Library.
-
- Telephone orders: 800-242-4775
-
- The PSL supplies Shareware software at a nominal cost to its
- customers. Consider them for all your Shareware needs.
-
- PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 23
- ----------------------------------------------------------------------
-
- PCOPY 7.87 Registration Request
-
- Thank you for your registration. It is sincerely appreciated!
-
- VISA/Mastercard orders are only accepted through telephone orders.
- Call the Public (Software) Library at 800-242-4775 to order NOW!
-
- _____ Registration of all Patriquin Utilities with
- program disk and User's Guide........................$45.00
-
- When you register the below versions, you will receive registration
- codes along with the latest version of the utility.
-
- _____ PCOPY -- Advanced windowed DOS COPY alternative...$15.00
- _____ PALERT -- Warns you of low disk space..............$15.00
- _____ PATTR -- Manage attributes of DOS files...........$10.00
- _____ PDAILY -- Automatically execute commands once/day..$10.00
- _____ PDELETE -- Save space with automatic disk cleanup...$15.00
- _____ PPRINT -- Advanced file print w/special formats....$15.00
- _____ PSEARCH -- Advanced find files with text............$15.00
- _____ PTOUCH -- Change date and time on DOS files........N/C
-
- _____ Update a registered set with new disk and manual.
- Registered users only Ser: __________ ........... $15.00
-
- ****************************************************************
-
- Name: __________________________________________________
-
- Company: _______________________________________________
-
- Address: _______________________________________________
-
- _______________________________________________
-
- City: ________________________ State: ________ Zip: __________
-
- I learned about the utilities from: ____________________________
-
- If BBS indicate name and number please._________________________
-
- ________________________________________________________________
-
- Please register the software under the following name:
-
- ____________________________________________________________
-
- Send to: Norm Patriquin
- P.O. Box 8263
- San Bernardino, CA 92412
-
- PCOPY Users Guide/Reference Copyright 1989 N. Patriquin Page 24
- ----------------------------------------------------------------------
-
- Reporting Problems (PCOPY 7.87)
-
- I welcome all comments or enhancement suggestions. Please document
- each item clearly and provide printed examples, if possible. Please
- be sure to include this form with all requests. It will help to
- make sure we can provide you with the best possible service.
-
-
- Name: __________________________________________________________
-
- Company: _______________________________________________________
-
- Address: _______________________________________________________
-
- _______________________________________________________
-
- City: __________________________________ State: _______________
-
- Zip: ______________________________
-
- Telephone: _______ / ________________________ (Home / Work)
-
-
- Date: _________________________ Machine Type:_______________
-
-
- Name of Utility: _______________________ DOS Level: ____________
-
- Description of problem or enhancement:
-
- ________________________________________________________________
-
- ________________________________________________________________
-
- ________________________________________________________________
-
- ________________________________________________________________
-
- Suggested solution:
-
- ________________________________________________________________
-
- ________________________________________________________________
-
-